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PREFACE 


In-house testing of BATCH/DOS V08-02 uncovered several minor 
software and documentation problems. Correcting these software 
and documentation problems would have unduly delayed the current 
release. Since by nature the problems fall into an annoyance 
category , we have documented them and where possible suggested 
appropriate procedures for avoiding them. 

This document lists all known problems in BATCH/DOS V08-J2f2, 
the systems programs and FORTRAN. 

It is recommended that you read this document carefully 
before bringing up BATCH/DOS Vj0f 8— 02 on your system. 
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SOFTWARE SUPPORT CATEGORIES 


Digital Equipment Corporation (DEC) makes available four categories of software. These 
categories reflect the types of support a customer may expect from DEC for a specified software 
product. DEC reserves the right to change the category of a software product at any time. 

The four categories are as follows: 


CATEGORY I 

Software Products Supported at no Charge 

This classification includes current versions of monitors, programming languages, and 
support programs provided by DEC. DEC will provide installation (when applicable), advisory, 
and remedial support at no charge. These services are limited to original purchasers of DEC 
computer systems who have the requisite DEC equipment and software products. 

At the option of DEC, a software product may be recategorized from Category I to 
Category II for a particular customer if the software product has been modified by the customer 
or a third party . 


CATEGORY II 

Software Products that Receive Support for a Fee 

This category includes prior versions of Category I programs and all other programs avail- 
able from DEC for which support is given. Programming assistance (additional support), as 
available, will be provided on these DEC programs and non-DEC programs when used in con- 
junction with these DEC programs and equipment supplied by DEC . 


CATEGORY III 
Pre-Release Software 

DEC may elect to release certain software products to customers in order to facilitate 
final testing and/or customer familiarization. In this event, DEC will limit the use of such 
pre-release software to internal, non-competitive applications. Category II! software is only 
supported by DEC where this support is consistent with evaluation of the software product. 
While DEC will be grateful for the reporting of any criticism and suggestions pertaining to a 
pre-release, there exists no commitment to respond to these reports. 


CATEGORY IV 
Non - Su pport ed Software 

This category includes all programs for which no support is given 
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DOS Monitor Vj2f 8—02 


• File compatibility with RSX-11B,C . 

Files written under RSX-11B and C may be read under DOS V08-02. 
However, the reverse is not true. This is caused by changes to 
the file structure UFD format under V08-02. 

Files created under V4A may be processed under V08-02, pro- 
vided that they have been properly closed. However, files cre- 
ated under V08-02 must be unlocked before they can be used under 
V4A, A V08-02 file which has been unlocked under V4A cannot then 
be used under V08-02. However, if it is copied (under V4A) , the 
copy can be used under V08-02. 

o ASSIGN Keyboard Command 

The AS command does not work for group codes greater than 37 
octal. AS command without arguments will give a fatal F344 error. 

• Low Density Disk Initialization 

Version V08-02 does not work with low density RK disks. The 
system has initialization problems. 

• Line Printer out of paper 


The system hangs when the line printer is out of paper. 

• File Update (OPENU) 

V08-02 does not flag a linked file OPENed for update as an error. 

• Delete Files 


System may hang while deleting a file which contains a 
block with a hardware checksum error. 
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Allocate File 


The following sequence of Monitor requests will result in a 
fatal error. .INIT followed by .ALLOC which fails, gives a fatal 
error at . RLSE . .ALLOC failures should not issue a . RLSE request 
but should .EXIT instead. 

o Paper Tape BOOTSTRAP 

RM0N5 Monitor module clobbers paper tape bootstrap at top of 

core. 


• Nonexistent disk block reference 

RK driver hangs when a nonexistent disk block is refer- 
enced. 


• RUN EMT Error Message Problem 

All errors when executing the RUN EMT produce a message that 
states NO FILE even though a file with that name exists. The error 
message is ambiguous, as all of the errors in the RUN EMT take . a 
common return and therefore issue the same message. 

• RESET Instruction 


The keyboard commands BE, RE, KI, and ST, continue to issue 
RESETS . 

• Error Message 

There have been no changes to error processing. 

• Drivers 


V08-02 and V4A drivers are not interchangeable. 

• Access Privileges 

DOS is not able to check to see if a file is open for input 
when deciding whether to permit destructive access (i.e., a file 
which is open for output cannot be deleted, but a file which is open 
only for input can) . 
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Disk File Length 


When the last byte of data in a linked file coincides with the 
end of a block, an extra block is allocated. Straightforward copy- 
ing of the file will cause yet another block to be allocated, 

• Device EOM Processing v 

If the user does not check for End-of-Medium on .WRITE , a loop 
may result. 

• CSI Usage 

CSI2 returns a flag word on top of the stack. Bit 2 of the 
flag word will be set to 1 if the device code in the Link Block 
was set to a default value (i.e, , there was no device code in the 
dataset specifier) . Programs which use CSI may have to be changed. 

• Free Core Function 


The « MONF function is specified to return the first available 
location above the Resident Monitor. In Vj2f8-02, it does. In V4A, 
the value returned was 2 less than it should have been. 

• RUN Keyboard Command 


The lookup sequence for the RUN command has changed. If no 
extension is specified, an extension of LDA is tried first, fol- 
lowed by the name as specified. This sequence is tried first for 
the current UIC, then for UIC [1,1], unless a UIC is specified, in 
which case only the specified UIC is used. 

• Disk Corruption 

If the system crashes to the extent that rebooting the Monitor 
is the only recourse, the user must be aware that when a file is 
opened for creation, its initial directory entry is made immedi- 
ately. However, it is only when the file is closed that all the 

h1or«TfC! a 1 1 +- r\ i +- ano narmanonf 1 v r*o r*r\y~rhc\r\ ae cnnVi in f Vio 
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device bit map. Because of the crash, the file may not have been 
closed; some blocks assigned to it remain free and might be used 
for some other purpose. However, the initial directory entry still 
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exists and the only way to remove it is by deletion, which includes 
release of all blocks associated with the file. If the deletion 
is not done immediately after the crash and before any other opera- 
tions are carried out, it is possible that disk corruption can ensue. 
This can only be avoided by the user doing the necessary clean-up 
as soon as possible. 

The use of the BEGIN command after a program failure requires 
some care. The Monitor tries to clean up for the user by closing 
any files currently open for input and deleting any files not yet 
completely created. The Monitor employs its own methods for doing 
this rather than using normal file-structured operations, because 
such operations would attempt to write data stored in core which 
must be suspect following the program crash. In particular, no 
attempt is made to change bit maps as permanently recorded on the 
relevant device. This can mean that on disks which require several 
bit maps to cover their surface, some blocks allocated to the files 
being deleted will not be released for further use, even though the 
files themselves have been removed. A series of such crashes can 
thus lead to the disk being filled, although other evidence appears 
to contradict this. The user should therefore consider whether 
he should chance disk-corruption and use KILL rather than BEGIN and 
then delete the incomplete files with PIP. It also follows that if 
the automatic deletion effected by BEGIN could lose irrecoverable 
data to the user, he should KILL after a crash instead. 

q Swap Buffer Conflict 

It is legal to type a command to the Monitor at any time. 
However, if you are giving a command to the Monitor when it detects 
a situation requiring a diagnostic message (i.e., an OPEN failure 
in a running program while you are typing CTRL/C TI) , a conflict 
for the swap buffer will result. This causes the Monitor to hang. 

If this happens, a Monitor restart is required. 

• Dataset Specifications 

By its nature a dataset, other than one being updated, can 
supply input or accept output but not both simulatenously . There- 
fore, it is not possible to issue READ and WRITE commands to the 
same dataset at any one time and obtain meaningful results. Because 
a device such as paper tape reader or punch normally forces 
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uni-directional requests or because the device is treated as file- 
structured, an appropriate OPEN command must be issued to force 
the appropriate direction. The Monitor provides the necessary 
checks in such cases. However, it does not presently protect the 
user of the console device KB:, which is bi-directional and not 
file-structured. READ and WRITE on the same dataset will be ac- 
cepted but will cause invalid operations. The user must make two 
datasets available or, if the same dataset is used, logically change 
the direction by: .OPEN, .READ, .CLOSE, .OPEN, .WRITE, .CLOSE. 


© DEC'tape Directories 

When the attention message AJ?J?2 is printed by the Monitor 
because a DECtape is not ready, it is safe to dial the 
DEC tape (by rotating the thumb switch) to the proper drive number; 
unless the faulting request is OPENO, and the message is due to the 
requested drive being in WRITE LOCK status, and you wish to dial 
another transport to the drive number currently requested. In this 
one instance, the directory of the DECtape has already been read 
by the Monitor and the Monitor is unaware that the dialing took 
place. Therefore, the directory of the latter tape will be garbled. 

© Disk Write Protection 

The Monitor expects to be able to write on any part of a disk 
surface, therefore, the write protection must be disabled. In 
particular, the user should be careful to ensure that the appropri- 
ate switches are correctly set at times when there is no resident 
Monitor in core to produce the proper error diagnosis (i.e., during 
SYSLOD or a Monitor boot). Otherwise the system will not operate. 

• FINISH Keyboard Command 


This release of the Monitor has the following discrepancies 
with the DOS Monitor Programmers Handbook as published: 


No files are deleted on Finish, regardless of 
their protection codes. 
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Multiple PR Keyboard Commands 


Typing CTRL/C PR will terminate output to the console. If 
CTRL/C and any other command is then typed, the running job will 
hang. 


• CTRL/C during error message 

Typing CTRL/C during S, F, I or W error message printout 
causes the running job to hang. 

• Line feed termination of MO Keyboard Command 


More than 113^ LFs for the MO command will cause the system 
to hang. 

• Magtape Source Distribution 

The Magtape distribution of DOS sources contains two files 
named PST. MAC. One is for assembly with MACRO sources, the other 
is for assembly with FORTRAN sources. PST. MAC for FORTRAN is under 
UIC 1,1 while PST. MAC for MACRO may be found on UIC 200 , 200 . 

Monitor sources can be found under UIC [ 200 , 200 ] • 

• System Manager 1 s Guide Errata 

Page 2-10 Step 2 of Magtape procedure instructs the user to use /SU 
switch with PIP. The /SU switch will not work with Magtape, delete /SU 
references. The other alternative is to retain /SU but use the file- 
name on both input as well as the output side. 


Pages 4-1 and 4-3 refer to DV.QT. This option is not implemented and 
references to it or to device QT: are invalid throughout DOS V08-02 docu- 
mentation. 

Section B.3 indicates that the stack is longest during .OPEN proc- 
essing. In fact, the stack is longest during .RUN processing since .RUN 

uses .OPEN, 
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• The Monitor Support Sources DECtape (DEC-ll-OMSDA-A-UAO ) is not 
documented elsewhere. It's directory follows: 


DIRECTORY DT0* 

C 

l.l 3 


05-NOV-72 




SLDBLD.DK0 

9 

01„NOV-72 

<233> 

SRMNiK.MAC 

16 

31-0CT-72 

<233> 

SRMN2A f MAC 

21 

3 1* OCT- 72 

<233> 

SRMN3 .MAC 

18 

31-0CT-72 

<233> 

SRMN5A , MAC 

11 

31. “OCT -72 

<233> 

SRMN6A, MAC 

10 

31-0CT-72 

<233> 

SDT * M AC 

11 

31-0CT-72 

<233> 

SMT .MAC 

19 

31-0CT-72 

<233> 

SPR .MAC 

4 

31-0CT-72 

<233> 

SDC .MAC 

6 

31 -OCT -72 

<233> 

SDF .MAC 

6 

31. "OCT -72 

<233> 

SDK A .MAC 

9 

3 1 -OCT-72 

<233> 

SRWN .MAC 

52 

31-0CT-72 

<233> 

PRID02.MAC 

3 

31-0CT-72 

<?33> 

SIZE04. MAC 

11 

31-0CT-72 

<233> 

CMDV05 • MAC 

19 

31-0CT-72 

<233> 

SL0D36.MAC 

63 

31-0CT-72 

<233> 

MONC05 . MAC 

6 

31 -OCT- 72 

<233> 

INITIO. MAC 

20 

31-0CT-72 

<233> 

ERRS09. MAC 

5 

31-0CT-72 

<233> 

TT 101 0« MAC 

10 

31-OCT-72 

<233> 

SFCl .MAC 

13 

31-OCT-72 

<233> 

SCLS .MAC 

10 

31-0CT-72 

<233> 

SEDPA .MAC 

7 

31-OCT-72 

<233> 

SFOP .MAC 

15 

3 i-OCT-72 

<233> 

SLKP .MAC 

15 

31-OCT-72 

<233> 

SCVT .MAC 

18 

31-OCT-72 

<233> 

SCKX .MAC 

15 

31-OCT-72 

<233> 

SIRA .MAC 

9 

31-0CT-72 

<233> 

SINT .MAC 

14 

31-OCT-72 

<233> 

SCSXA .MAC 

15 

il-OCT-72 

<233> 

SCSMA .MAC 

13 

31-0CT-72 

<233> 

SMTO .MAC 

11 

3 1 - OCT- 72 

<233> 

SRLS .MAC 

8 

31-0CT-72 

<233> 

SOPN .MAC 

16 

31-0CT-72 

<233> 

LDUMP .BLD 

2 

31-0CT-72 

<233> 

LDMPH.FTN 

17 

31-0CT-72 

<233> 

C$114 .PAL 

11 

31-OCT-72 

<233> 

ICO03 .PAL 

5 

3! "OCT-72 

<233> 

CREATE. OKI 

15 

31 "OCT- 72 

< ? 3 3 > 

FREE BLKS: 

4 



FREE FILES; 

16 
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SYSLOD 



System will hang up when SYSLOD attempts to find a nonexistent 
LICIL on a magtape, or if LICIL exists on the magtape under a differ- 
ent UIC. 


SYSLOD 


If it is desired to copy a DECtape containing a SYSLOD. CIL in 
bootable format it is necessary to use either a block -by-block 
DECtape copy program or CILUS. The nature of the SYSLOD file does 
notallow it to be copied by PIP as it is a position-dependent con- 
tiguous file. 
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CILUS VfflA69 


• UIC Problem 


CILUS does not handle UIC properly in command strings, i.e., if 
you run when logged under 200,200 it will not handle /LI in a differ- 
ent UIC. 

• .LCL on a DECtape 

CILUS gives an error message and at times may clobber the disk 
if you attempt to create a .CIL on disk, list on a line printer, 
and a .LCL on DECtape in one command string. The problem can 
be avoided by creating both ,CIL and .LCL on disk and then PIPing 
the resultant .LCL to a DECtape. 

• listing Switch 

Listings produced via the second field in a command string do 
not match those produced by /LI Switch. /LI produces the correct 
listings. 

• 8K Systems 

CILUS will not fit in 8K and therefore cannot be used on 8K 
systems . 

• CILUS Version Number 


All the documentation on CILUS refers to V4A of CILUS, while 
the typeout from CILUS is V01A69. CILUS will be corrected in the 
future to type out V4A. 
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BATCH Monitor V08 


BATCH Monitor V08 has all the problems described under DOS V08. 
The following problems are particular to BATCH V08. 

• CTRL/C Problem 

The system may hang up while running BATCH , when a user types 
CTRL/C to gain console control. 

o BATCH Crash After AO 02 


With card reader as Bis device, a TE or KI command after an A002 
error crashes the BATCH system. 

• Blank Suppress Card 

If a blank suppress card is not the first card in the deck, 
the system not only does not suppress blanks, but prints a ? at 
the end of each line. 

e Control Cards 


Following control cards will be recognized by Version 08. 


Control Cards 


Column 1 Pattern 


EOF 

026 

029 

Blank suppress 


12-11-0-1-6-7-8-9 

12-2-4-8 

12-0-2-4-6-8 

12-11-0-7-8-9 


• End of Card Deck 


A blank card is required at the end of every card deck. 

• BATCH Dataset 


In order to run under BATCH, standard dataset names must be used 
for command input (CMI) , command output (CMO) , program command input 
(PCI), and command data input (CDI) . See the Batch-11 User's Manual 
(Chapter 4) for details. 
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Default UIC 


The default UIC is 2,1 not 1,2 as specified. 
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LINKER V11A01 


• Long Command String Problem 

The LINKER cannot handle command strings longer than one line 
if the /OV switch is specified. This is due to an improper algorithm 
for allocating stack space at the time the /OV switch is seen. This 
problem may be circumvented by not using the /OV switch on overlay 
links having long command strings. The only way this will work is 
to explicitly specify the output symbol table on the main link and 
to explicitly specify the input symbol table on each of the subsidi- 
ary links. 


• Multiply Defined Global's Message 

Under DOS multiply defined globals cause a message to be printed 
on KB:. Under BATCH such messages will be lost if no log file dataset 
is specified. 
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PIP V7A01 


• Magtape Handling 

In-house testing of PIP V7A01 has uncovered several problems 
in the magtape handling. These are: 

• * construction fails in some cases. 


• There may be a problem copying from one magtape to 
another magtape if number of files exceeds 30 on a 
28K machine. 
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FORTRAN 


Identification Numbers - Document DEC-11-LF0AA-B-D 


Various identification numbers for paper tapes are incorrectly 
shown. The correct numbers are as follows: 


Item 


Document Reads 


Should Read 


Compiler Concatenated Object 
Modules 


DEC-11-LFCDA-A-PRl DEC-1 1-LFC0A-A-PR1 
(through) -PR15 (through) -PR15 


OTS V20A Diagnostic File DEC-ll-LFDGA-B-PL DEC-ll-LFDBA-A-PL 

(Pre-Built) 


OTS Library Tapes - 
FORMOD . OBJ 


DEC-11-LF0MA-B-PR1 DEC-ll-LFLTA-A-PRl 
(through) ^PR6 (through) -PR6 


EISMOD .OBJ 


DEC-ll-LFEMA-B-PR DEC-ll-LFEIA-A-PR 


FPUMOD . OBJ 


DEC-ll-LFPMA-B-PR DEC-1 1-LFFPA-A-PR 


• PDP-11/40 Users 


System building instructions for the PDP-11/40 are not contained 
in the "Getting FORTRAN on the Air”. PDP-11/40 users should note the 
following: 


Chapters 1 through 3 , 5 and 6 (all except Chapter 4) 
may be followed as presented for all operations ex- 
cept building the FORTRAN OTS. 


To build an OTS - 

for 11/40 without EAE, EIS or FIS, follow the direc- 
tions for basic 11/20, i.e., use the 
FORLIB.OBJ library 

for 11/40 with EAE, follow the directions for 11/20 
with EAE, i.e., use the EAELIB .OBJ library 

for 11/40 with EIS, follow the directions for basic 
11/45, i.e., use the EISLIB.OBJ library 

for 11/40 with FIS follow the directions for basic 
11/45, i.e., use the EISLIB.OBJ library 
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NOTE 


Support for 11/40 FIS is not included in this 
release. It will be available separately at 
a later time. 


NOTE 

FORTRAN has not been thoroughly tested on 
11/40 configurations. Consequently , such 
use will be considered to be unsupported 
for the time being. However , very limited 
testing has revealed no problems. Software 
Performance reports on user experience of 
DOS/FORTRAN on 11/40 will be appreciated. 


Typographical Errors 



Page & 

Section 

Reads 

Should Read 

1-2, 

1.5.1 

FORTRAN. OBJ 

FORTRN . OBJ 

4-4, 

4.3 

$RU LIBR 

$RU PIP 

4-4, 

4.3 

$RU PUP 

$RU PIP 


• FORTRAN Building Control Files 


Four BATCH control files for building the FORTRAN Compiler and 
OTS from the distributed sources are included with the source file 
kits. They are included for information only and may need to be 
adapted for a given user environment. The files are: 


ASMCOM. 4 A 
BLDCOM. 4A 

ASMOTS.20A 

BLDOTS.20A 


To assemble the compiler sources. 

To build the compiler from the assembled 
object modules. 

To assemble OTS sources. 

To build libraries from OTS object modules. 


These control files are largely self-documenting and should be listed, 
understood and edited as appropriate before use. 
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HOW TO OBTAIN SOFTWARE INFORMATION 


Announcements for new and revised software, as well as programming notes, software problems, 
and documentation corrections are published by Software information Service in the following 
newsletters. 


Digital Software News for the PDP-8 and PDP-12 
Digital Software News for the PDP-11 
Digital Software News for 18-bit Computers 


These newsletters contain information applicable to software available from Digital's Software 
Distribution Center. Articles in Digital Software News update the cumulative Software Per- 
formance Summary which is contained in each basic kit of system software for new computers. To 
assure that the monthly Digital Software News is sent to the appropriate software contract at your 
installation, please check with the Software Specialist or Sales Engineer at your nearest Digital 
office. 


Questions or problems concerning Digital's software should be reported to the Software Specialist. 
In cases where no Software Specialist is available, please send a Software Performance Report 
form with details of the problems to: 

Digital Equipment Corporation 
Software Information Service 
Programming Department 
Maynard, Massachusetts 01754 


These forms, which are provided in the software kit, should be fully filled out and accompanied 
by Teletype output as well as listings or tapes of the user program to facilitate a complete inves- 
tigation. An answer will be sent to the individual and appropriate topics of general in- 
terest will be printed in the newsletter. 


Orders for new and revised software manuals, additional Software Performance Report forms, and 
software price lists should be directed to the nearest Digital Field office or representative. USA 
customers may order directly from the Software Distribution Center in Maynard. When ordering, 
include the code number ond a brief description of the software requested. 

Digital Equipment Computer Users Society (DECUS) maintains a user library and publishes a cata- 
log of programs as well as the DECUSCOPE magazine for its members and non -members who request 
it. For further information, please write to: 

Digital Equipment Corporation 
DECUS 

Programming Department 
Maynard, Massachusetts 01754 
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READER'S COMMENTS 


Digital Equipment Corporation maintains a continuous effort to improve the quality and usefulness 
of its publications. To do this effectively we need user feedback — your critical evaluation of 
this manual . 

Please comment on this manual's completeness, accuracy, organization, usability, and read- 
ability. 


Did you find errors in this manual? If so, specify by page. 


How can this manual be improved? 


Other comments? 


Please state your position. 



Date: 

Name: 


Organization: 


Street: 


Department: 


City: 

State: 


Zip or Country 



Do Not Tear - Fold Here and Staple 


FIRST CLASS 
PERMIT NO. 33 
MAYNARD, MASS. 


BUSINESS REPLY MAIL 

NO POSTAGE STAMP NECESSARY IF MAILED IN THE UNITED STATES 


Postage will be paid by: 



Digital Equipment Corporation 
Software Information Services 
Programming Department 
Maynard, Massachusetts 01754 





